W07-1. Deployment - 강의 노트
7주차 강의 노트: Deployment (자가 치유 · 스케일링 · 롤링 업데이트 · 롤백)
- Deployment → ReplicaSet → Pod 의 관계를 설명할 수 있다.
- Pod 를 지워도 스스로 되살아나는 원리(조정 루프 + 라벨)를 안다.
- 롤링 업데이트가 무중단으로 버전을 바꾸는 과정을 설명할 수 있다.
- 잘못 배포했을 때 롤백할 수 있다.
진행: 이론 15분 (이 노트) → 실습 45분 (실습 가이드)
- Kubernetes = 원하는 상태를 선언하면 조정 루프가 맞춰 줌
- Pod = 가장 작은 단위. 직접 만든 Pod 는 지우면 그대로 사라짐
1. Deployment 가 하는 일
Deployment 는 "이 Pod 를 항상 N개 유지하고, 버전을 바꿀 때는 안전하게 바꿔 줘" 라고 선언하는 오브젝트입니다. 실무에서 앱(웹, API 등)을 띄울 때 가장 많이 쓰는 방법입니다.
flowchart TB
D["Deployment: guestbook
replicas: 3, image: v1
(버전 관리 담당)"] --> RS["ReplicaSet: guestbook-6694d9fcc5
'app=guestbook Pod 를 3개 유지'
(개수 담당)"]
RS --> P1["Pod
guestbook-6694d9fcc5-8f9bh"]
RS --> P2["Pod
guestbook-6694d9fcc5-pwp8r"]
RS --> P3["Pod
guestbook-6694d9fcc5-zlp58"]| 오브젝트 | 책임 | 우리가 직접 만드나? |
|---|---|---|
| Deployment | 버전 관리: 업데이트 방식, 이력, 롤백 | ✅ (YAML 로) |
| ReplicaSet | 개수 관리: "라벨이 맞는 Pod 를 N개 유지" | ❌ (Deployment 가 자동 생성) |
| Pod | 실제 컨테이너 실행 | ❌ (ReplicaSet 이 자동 생성) |
guestbook-6694d9fcc5-8f9bh = Deployment 이름 + ReplicaSet 고유 번호 + Pod 고유 번호
ReplicaSet 번호는 Pod 설계도(template)의 지문입니다. 이미지 버전이 바뀌면 지문이 바뀌어 새 ReplicaSet 이 생깁니다.
2. Deployment YAML 읽기
apiVersion: apps/v1 # Deployment 는 apps/v1
kind: Deployment
metadata:
name: guestbook
annotations:
kubernetes.io/change-cause: "v1 최초 배포" # 배포 이력에 남길 메모
spec:
replicas: 3 # ① 몇 개 유지할지
selector:
matchLabels:
app: guestbook # ② "이 라벨이 붙은 Pod 가 내 것"
template: # ③ Pod 설계도 (6주차 pod.yaml 의 내용이 여기로)
metadata:
labels:
app: guestbook # ②와 반드시 같아야 함
spec:
containers:
- name: web
image: 내아이디/guestbook:v1
ports:
- containerPort: 8000
| 부분 | 의미 |
|---|---|
replicas |
원하는 Pod 개수 |
selector.matchLabels |
어떤 Pod 를 내 것으로 셀지 정하는 조건 |
template |
새 Pod 를 만들 때 쓰는 설계도. 6주차 pod.yaml 의 metadata + spec 과 같은 모양 |
template.metadata.labels |
만들어질 Pod 에 붙일 라벨. selector 와 일치해야 합니다 (안 맞으면 apply 할 때 에러) |
3. 자가 치유: 라벨로 세고, 모자라면 만든다
ReplicaSet 의 조정 루프는 아주 단순합니다.
flowchart LR
C["app=guestbook 라벨이 붙은
Pod 개수 세기"] --> Q{"원하는 개수(3)와
같은가?"}
Q -- "2개 (하나 죽음)" --> A["1개 새로 만들기"]
Q -- "4개 (하나 많음)" --> B["1개 지우기"]
Q -- "3개" --> C
A --> C
B --> C| 상황 | ReplicaSet 의 반응 |
|---|---|
| Pod 하나를 지웠다 / 앱이 죽었다 | 2개 → 새로 1개 생성 (새 이름, 새 IP) |
| 노드(서버) 하나가 고장 났다 | 그 노드의 Pod 가 사라짐 → 다른 노드에 새로 생성 |
| Pod 의 라벨을 바꿨다 | 라벨이 다르니 "내 것이 아님" → 2개로 세고 새로 1개 생성. 라벨을 바꾼 Pod 는 관리 밖으로 빠져 그대로 남음 |
"라벨을 바꾸면 관리 대상에서 빠진다" 는 것은, 문제가 생긴 Pod 를 서비스에서 떼어 내 조사할 때 실무에서도 쓰는 요령입니다.
스케일링
replicas 숫자만 바꾸면 됩니다.
| 방법 | 명령 |
|---|---|
| 선언형 (권장) | YAML 의 replicas: 5 로 고치고 kubectl apply -f |
| 명령형 (급할 때) | kubectl scale deployment guestbook --replicas=5 |
트래픽에 따라 자동으로 늘리고 줄이는 것(HPA)은 10주차에 합니다.
4. 롤링 업데이트: 하나씩 바꿔 끼우기
이미지를 v1 → v2 로 바꾸고 apply 하면, Deployment 는 새 ReplicaSet 을 만들고 조금씩 옮겨 갑니다.
flowchart TB
S0["시작
v1 ●●● / v2 (없음)"] --> S1["① v2 1개 추가
v1 ●●● / v2 ●"]
S1 --> S2["② v2 준비되면 v1 1개 종료
v1 ●● / v2 ●"]
S2 --> S3["③ 반복
v1 ● / v2 ●●"]
S3 --> S4["완료
v1 (0개, 이력용으로 남음) / v2 ●●●"]- 업데이트하는 동안 항상 서비스 가능한 Pod 가 있습니다. 그래서 무중단 배포입니다.
- 옛 ReplicaSet 은 지우지 않고 Pod 0개로 남겨 둡니다. 그래서 롤백이 빠릅니다.
속도와 안전의 조절: maxSurge, maxUnavailable
| 설정 (기본값) | 의미 | replicas 3 일 때 |
|---|---|---|
maxSurge: 25% |
업데이트 중 원하는 개수보다 최대 몇 개 더 띄울 수 있나 | 3 × 25% = 0.75 → 올림 1개 (최대 4개까지) |
maxUnavailable: 25% |
업데이트 중 최대 몇 개까지 모자라도 되나 | 3 × 25% = 0.75 → 내림 0개 (항상 3개 유지) |
그래서 replicas 3 의 기본 동작은 "1개 추가 → 준비되면 1개 종료" 를 반복합니다. 실습에서
kubectl get pods -w로 이 순서를 직접 봅니다.
Recreate
strategy: type: Recreate 로 설정하면 전부 끄고 → 전부 새로 켭니다. 잠깐 서비스가 끊기지만, 두 버전이 동시에 돌면 안 되는 앱에 씁니다.
5. 배포 이력과 롤백
5-1. 이력에 메모 남기기
metadata.annotations 의 kubernetes.io/change-cause 에 적은 내용이 배포 이력에 남습니다.
$ kubectl rollout history deployment/guestbook
REVISION CHANGE-CAUSE
1 v1 최초 배포
2 v2 배포 (초록)
3 v9 배포 (실수)
5-2. 잘못된 배포는 어떻게 되나 (실습에서 직접 겪음)
존재하지 않는 이미지 v9 를 배포하면:
NAME READY STATUS RESTARTS AGE
guestbook-5c96fffb47-p5pgw 0/1 ErrImagePull 0 30s ← 새 버전 1개: 실패
guestbook-5f994cddb4-c566p 1/1 Running 0 32s ← 기존 v2 3개: 그대로 서비스 중
guestbook-5f994cddb4-f89d9 1/1 Running 0 31s
guestbook-5f994cddb4-q74qh 1/1 Running 0 33s
새 Pod 가 준비(Ready)되지 않으면 기존 Pod 를 내리지 않습니다. 배포가 실패해도 서비스는 계속 됩니다. 사람이 상황을 보고 롤백하면 됩니다.
5-3. 롤백
| 방법 | 명령 | 언제 |
|---|---|---|
| 바로 전 버전으로 | kubectl rollout undo deployment/guestbook |
급할 때 |
| 특정 버전으로 | kubectl rollout undo deployment/guestbook --to-revision=1 |
|
| YAML 을 고쳐서 다시 apply (권장) | 파일의 이미지를 되돌리고 kubectl apply -f |
평소 |
rollout undo 후에는 YAML 파일도 맞춰 두세요
undo 는 클러스터만 되돌리고 내 YAML 파일은 그대로입니다(파일에는 여전히 v9). 다음에 무심코 apply 하면 또 v9 가 배포됩니다.
실제로 kubectl 도 경고를 띄웁니다: Rolling back will not update the kubectl.kubernetes.io/last-applied-configuration annotation ...
실무에서는 "파일(Git)이 진실" 이 되도록, 파일을 고쳐 apply 하는 방식으로 되돌립니다(10주차 GitOps 맛보기).
핵심 요약
7주차 핵심
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
① 관계 Deployment(버전) → ReplicaSet(개수) → Pod(실행)
② 핵심 필드 replicas / selector.matchLabels / template(Pod 설계도)
selector 와 template 의 라벨은 같아야 한다
③ 자가 치유 "라벨 맞는 Pod 를 세고, 모자라면 만든다" → 죽어도, 노드가 고장 나도 복구
④ 스케일 replicas 숫자만 바꾼다 (apply 또는 kubectl scale)
⑤ 롤링 업데이트 새 ReplicaSet 을 만들고 하나씩 교체 → 무중단
새 Pod 가 준비되지 않으면 옛 Pod 를 내리지 않는다 (안전장치)
⑥ 롤백 kubectl rollout undo (그다음 YAML 파일도 꼭 맞춰 두기)
참고 자료
더 깊이 보고 싶다면 (볼트 내 정리 노트):
- 쿠버네티스 개요2: Deployment 스케일링, 롤링 업데이트, StatefulSet
- 쿠버네티스 개요1: 라벨을 바꾸면 관리 대상에서 빠지는 실험
- Deployment: 개념 노트
공식 문서:
- Deployments: https://kubernetes.io/docs/concepts/workloads/controllers/deployment/
- kubectl rollout: https://kubernetes.io/docs/reference/kubectl/generated/kubectl_rollout/